Conversation
💙 Build successful! 💙Preview deployment: https://schema-docs-bluebuild-website.xyny.workers.dev/ |
|
I think it would help the reader understand what's a property if you did something like #### `configurations[].notify`, `boolean`I feel like a path would make the structure clearer than having to rely on counting the number of |
|
Latest push made this again way better (and pretty robust). I think this could be a possible final version as well. I could not get the full property path version working today yet, but maybe I'll be able to get it to work another day if we still find that necessary. |
|
Yeah, I think this PR is done now. I find it readable enough without the property syntax you suggested, though I am still open to implementing that in the future. The recipe schema also needs some additions and cleanup, though, to make this version of the docs as good as the last one. I'll mark this ready for review, but wont merge until schema changes are made. |
|
Generating docs for the generic module ref page is unfortunately not possible right now, as we do not generate a JSONSchema that would match that page's contents in any desirable way. May be supported in the future with the code improvements in this PR, though. |
|
Prerequisite PR blue-build/schema#15 |

Ended up rolling my own solution.
Some warts still, but already way better than the previous version.
Once the preview deploy is out, y'all can see the new format the generated docs take. Might need some discussion still, I am not 100% on this.
TODO